home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Belgian Amiga Club - ADF Collection
/
BS1 part 47.7z
/
BS1 part 47
/
ImageMaster RT v1.50b (1994)(Black Belt Systems)(Disk 4 of 7)[HD].7z
/
ImageMaster RT v1.50b (1994)(Black Belt Systems)(Disk 4 of 7)[HD].adf
/
apa.lzh.parta
/
hlp_arexx5
< prev
next >
Wrap
Text File
|
1994-04-08
|
20KB
|
802 lines
\ApAssist
\: - This is the Quick Help for the ARexx in IM R/t -
\: ----------------------------------------------------------
\: Written by David E. Patterson
\: ----------------------------------------------------------
\font topaz.font 8
\tc 1
\wr
\lj
\dd "imh_descriptor"
\index "hlp_arexx2/askyn-cellular"
\toc "imh_toc/toc"
\help "aa_help/help
\node "asterize"
\title "Asterize"
\next "astprofile"
\prev ""
\{ \tc 15 Asterize/Ast \} - Puts a star-shaped effect on the screen.
\{ \nw
Usage - '\{ \tc 15 asterize <red> <green> <blue> <width> <centersat>
<taper> <arms> <rotation angle> <additive> <center hot spot\} '
\{ \ce \nw or\}
'\{ \tc 15 ast <red> <green> <blue> <width> <centersat>
<taper> <arms> <rotation angle> <additive> <center hot spot>'\} \}
\{ \nw
<red> value: 0 - 255
<green> value: 0 - 255
<blue> value: 0 - 255
<width> value: 1 - 100
<centersat> value: 0 - 100
<taper> On/Off
<arms> value: 1 - 100
<rotation angle> value: 0 - 360 degrees
<additive> On/Off
<center hot spot> On/Off\}
\{ \ra \image "Clips/Bigsplat.pic" l 10 \cap
It is important to remember that the \{ \tc 15 <taper>\} , \{ \tc 15 <arms>\} , and
\{ \tc 15 <rotation angle> \} do not need to be specified. If they are
not altered, they will default to the last asterization settings for those
values. The sample script does not contain the value for \{ \tc 15 <rotation
angle>\} . It is also important to remember that if you do not use the \{
\ts b \tc 15 Astprofile \} command, then the last setting of the arm profile
will be used.\}
\{ \ts bu Sample Script\} :
\{ \nw
options results;
'askrgb';
colors = result;
parse var colors red','grn','blu;
'askprop "Width(in pixels):"10 1 100';
size=result;
'askprop % Center Saturation Percent: 50 0 100';
satur=result;
'askyn "Taper ON" "Taper OFF"';
taper = result;
'askprop "Number of arms: 50 0 100';
arms = result;
options;
'\{ \tc 15 asterize\} 'red grn blu size satur taper arms;
'redraw';\}
* User Interface: \{ \tc 15 Process Panel
Special Effects
Asterize\}
\endnode
\node "astprofile"
\title "Astprofile"
\next "autoactivate"
\prev "asterize"
\{ \tc 15 Astprofile \} - Allows you to alter the Asterization graph or get
the values of the graph.
The \{ \tc 15 Astprofile \} command allows you to alter the asterization
graph, and should be used with the Asterize function. There is also a
setting for the use of the \{ \ts b Reflective \} tool. The next call to \{
\tc 15 Astprofile \} allows you to determine the graph position and level.
If the level value is not set, then only the position will be returned. To
alter the graph set a loop to find the position , and then alter the level.
The graph has a total of 201 positions. Remember that the loop will be half
as long if the \{ \ts b Reflect \} setting is on.
\nw
Usage - First Call:
'\{ \tc 15 astprofile <reflect> 0\} ' (off)
'\{ \tc 15 astprofile <reflect> 1\} ' (on)
Second Call:
'\{ \tc 15 astprofile <position> <level>\} '
\{ \ts bu Sample Script\} :
'\{ \tc 15 astprofile reflect 1\} '
do i=0 to 200
j = i * 255/200;
'\{ \tc 15 astprofile '||i||' '||j\} ;
end
'rect 100 100 300 300';
'asterize 255 0 0 20 10 0 5 30';
'finish';
\endnode
\node "autoactivate"
\title "Auto Activate"
\next "autoprimary"
\prev "asterize"
\{ \tc 15 Autoactivate \} - Changes automatic re-activation of main control
panel.
\nw
Usage - '\{ \tc 15 autoactivate 0\} ' (off)
'\{ \tc 15 autoactivate 1\} ' (on)
\{ \ts bu Sample Script\} :
options results;
'askyn "Autoactivate ON" "Autoactivate OFF"';
flag = result;
options;
'\{ \tc 15 autoactivate\} ' flag;
* User Interface: \{ \tc 15 Display Panel
Auto-Activate\}
\endnode
\node "autoprimary"
\title "Auto Primary"
\next "autoredraw"
\prev "autoactivate"
\{ \tc 15 Autoprimary \} - Makes newly allocated buffer the primary buffer.
This directs the placement of new buffers. In Mode 0, the new buffer does
not become the primary unless there is no Primary Buffer. In Mode 1, the new
buffer always becomes the Primary Buffer.
\nw
Usage - '\{ \tc 15 autoprimary <mode>\} '
\{ \ts bu Sample Script\} :
options results;
'askyn "Autoprimary OFF" "Autoprimary ON"';
flag = result;
options;
'\{ \tc 15 autoprimary\} ' flag;
\endnode
\node "autoredraw"
\title "Auto Redraw"
\next "autosize"
\prev "autoprimary"
\{ \tc 15 Autoredraw \} - Turns redraw on or off.
\nw
Usage - '\{ \tc 15 autoredraw <mode>\} '
\{ \ts bu Sample Script\} :
options results;
'askyn "Autoredraw OFF" "Autoredraw ON"';
flag = result;
options;
'\{ \tc 15 autoredraw\} ' flag;
\endnode
\node "autosize"
\title "Autosize"
\next "backin"
\prev "autoredraw"
\{ \tc 15 Autosize \} - This command can be used to turn the autosize control
on and off. If this control is on, the fade length of a brush and the length
of a range will automatically be set to the length of the line that is drawn.
If this control is off, the fade length will default to the fade length
setting, and the range will cycle based on the number of colors in the range.
The fade length can be set using an arexx command (fadelength) or can be set
in the \{ \ts b Draw Mode \} panel.
\nw
Usage - '\{ \tc 15 autosize <mode>\} '
Where the mode is auto size on or off (1 or 0).
\{ \ts bu Sample Script\} :
/* arexx Linemode Example */
address('IM_Port');
'newline';
'\{ \tc darkblue autosize 1\} ';
'linemode 1';
'move 30 30';
'draw 30 270';
'stroke';
'finish';
\endnode
\node "backin"
\title "Backin"
\next "backuptoundo"
\prev "autosize"
\{ \tc 15 Backin \} - This command was originally used for compatibility with
the \{ \ts b 'jackin' \} command, but is no longer needed. Use the \{ \ts b
'plugin' \} command instead of backin.
See Also: \{ \nw \ts b \link "Developing PI Modules" "imdoc:imh_custom/custom"
\link " Jackin " "imdoc:hlp_arexx8/jackin"
\link " Plugin " "imdoc:hlp_arexx9/plugin"
\}
\endnode
\node "backuptoundo"
\title "Backup to Undo"
\next "balance"
\prev "backin"
\{ \tc 15 Backuptoundo \} - Copies the current primary buffer, making an UNDO
possible.
Used before a process is performed to copy the initial contents of the
primary buffer into the UNDO buffer, making an Undo possible.
\nw
Usage - '\{ \tc 15 backuptoundo\} '
\{ \ts bu Sample Script\} :
'\{ \tc 15 backuptoundo\} ';
'area';
'areafill 100 120 190';
\endnode
\node "balance"
\title "Balance"
\next "blenddefs"
\prev "backuptoundo"
\{ \tc 15 Balance \} - White correction.
This Arexx command will determine the correction necessary to make the
selected area 100% saturated white, and then will carry out the correction.
\nw
Usage - '\{ \tc 15 balance\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 balance\} ';
See also: \{ \ts b \link "gray" "imdoc:hlp_arexx7/gray"\}
* User Interface: \{ \tc 15 Process Panel
Standard Adjustments
White Balance\}
\endnode
\node "blenddefs"
\title "Blend Definitions"
\next "blendext"
\prev "balance"
\{ \tc 15 Blenddefs \} - Returns path and extension of a saved blend.
\nw
Usage - '\{ \tc 15 blenddefs\} '
\{ \ts bu Sample Script\} :
options results;
'\{ \tc 15 blenddefs\} '
parse var result path ','extension;
options;
See also: \{ \ts b \link "imagedefs " "imdoc:hlp_arexx7/imagedefs"
\link "macrodefs " "imdoc:hlp_arexx8/macrodefs"
\link "palettedefs" "imdoc:hlp_arexx9/palettedefs"
\link "renderdefs " "imdoc:hlp_arexx10/renderdefs"\}
\endnode
\node "blendext"
\title "Blend Extensions"
\next "blendload"
\prev "blenddefs"
\{ \tc 15 Blendext \} - Set a new extension for loading and saving blends.
\nw
Usage - '\{ \tc 15 blendext <newext>\} '
\{ \ts bu Sample Script\} :
'\{ \tc 15 blendext .bld\} ';
See Also: \{ \ts b \link "imageext " "imdoc:hlp_arexx7/imageext"
\link "macroext " "imdoc:hlp_arexx8/macroext"
\link "paletteext" "imdoc:hlp_arexx9/paletteext"
\link "renderext " "imdoc:hlp_arexx10/renderext"\}
* User Interface: \{ \tc 15 Setup Panel
Blend Ext\}
\endnode
\node "blendload"
\title "Blend Load"
\next "blendpath"
\prev "blendext"
\{ \tc 15 Blendload \} - Loads a blend.
\nw
Usage - '\{ \tc 15 blendload <blendname>\} ' (without path or extension)
\{ \ts bu Sample Script\} :
'blendpath work:blends';
'\{ \tc 15 blendload myfile.ibp\} ';
'merge';
See Also: \{ \ts b \link "loadasblend " "imdoc:hlp_arexx8/loadasblend"
\link "loadasbrush " "imdoc:hlp_arexx8/loadasbrush"
\link "loadasprimary " "imdoc:hlp_arexx8/loadasprimary"
\link "loadassecondary " "imdoc:hlp_arexx8/loadassecondary"
\link "loadimask " "imdoc:hlp_arexx8/loadimask"
\link "loadmask " "imdoc:hlp_arexx8/loadmask"\}
* User Interface:\{ \tc 15 Process Panel
Load Blend\}
\endnode
\node "blendpath"
\title "Blend Path"
\next "Blueadj"
\prev "blendload"
\{ \tc 15 Blendpath \} - Set new path for loading and saving blends.
\nw
Usage - '\{ \tc 15 blendpath <newpath>\} '
\{ \ts bu Sample Script\} :
'\{ \tc 15 blendpath work:blends\} ';
'blendload myfile.ibp';
'merge';
See Also: \{ \ts b \link "imagepath " "imdoc:hlp_arexx7/imagepath"
\link "macropath " "imdoc:hlp_arexx8/macropath"
\link "palettepath" "imdoc:hlp_arexx9/palettepath"
\link "renderpath " "imdoc:hlp_arexx10/renderpath"\}
* User Interface: \{ \tc 15 Setup Panel
Blend Path\}
\endnode
\node "blueadj"
\title "Blue Adjust"
\next "bluecont"
\prev "blendpath"
\{ \tc 15 Blueadj \} - Changes the blue brightness of selected area.
\nw
Usage - '\{ \tc 15 blueadj <amount>\} '
\{ \tc 15 Amount: 0 - 100\}
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 blueadj 89\} ';
See Also: \{ \ts b \link "greenadj" "imdoc:hlp_arexx7/greenadj"
\link "redadj " "imdoc:hlp_arexx10/redadj"\}
* User Interface: \{ \tc 15 Process Panel
R,G,B Corrections
Blue\}
\endnode
\node "bluecont"
\title "Blue Contrast"
\next "blur"
\prev "blueadj"
\{ \tc 15 Bluecont \} - Changes the blue contrast for a selected area.
\nw
Usage - '\{ \tc 15 bluecont <%>\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 bluecont 89\} ';
See Also: \{ \ts b \link "greencont" "imdoc:hlp_arexx7/greencont"
\link "redcont " "imdoc:hlp_arexx10/redcont"\}
* User Interface: \{ \tc 15 Process Panel
R,G,B Corrections
Blue Cont.\}
\endnode
\node "blur"
\title "Blur"
\next "bprint"
\prev "bluecont"
\{ \tc 15 Blur \} - Creates a motion blur effect.
\nw
Usage - '\{ \tc 15 blur <length> <direction> [angle]\} '
\{ \tc 15 length - in pixels\}
\{ \tc 15 direction - 0 = up
1 = right
2 = down
3 = left
4 = arbitrary\}
\{ \tc 15 angle - angle of arbitrary direction\}
\{ \ts bu Sample Script:\}
'area';
'\{ \tc 15 blur 30 2 45\} ';
See Also: \{ \ts b \link "smear" "imdoc:hlp_arexx11/smear"
\link "warp " "imdoc:hlp_arexx12/warp"\}
* User Interface: \{ \tc 15 Process Panel
Geometric
Motion Blur\}
\endnode
\node "bprint"
\title "Blue Print"
\next "bright"
\prev "blur"
\{ \tc 15 Bprint \} - Converts a selected region to blue line art.
\nw
Usage - '\{ \tc 15 bprint\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 bprint\} ';
See Also: \{ \ts b \link "lineart" "imdoc:hlp_arexx8/lineart" \}
* User Interface: \{ \tc 15 Process Panel
Special Effects
Blue Print\}
\endnode
\node "bright"
\title "Bright"
\next "brushtran"
\prev "bprint"
\{ \tc 15 Bright \} - Changes the brightness of a selected area.
\nw
Usage - '\{ \tc 15 bright <%>\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 bright 40\} ';
See Also: \{ \ts b \link "contrast" "imdoc:hlp_arexx6/contrast"\}
* User Interface: \{ \tc 15Process Panel
Standard Adjustments
Brightness\}
\endnode
\node "brushtran"
\title "Brush Transparency"
\next "buffer"
\prev "bright"
\{ \tc 15 Brushtran \} - The brushtran command is used to specify the brush
transparency for painting in Imagemaster. The transparency can be set to
additive transparency, absolute transparency, or no transparency.
\nw
Usage - '\{ \tc 15 brushtran ON/ABS/OFF\} '
\{ \ts bu Sample Script\} :
/* arexx Brush Transparency Example */
address('IM_Port');
'newline';
'linemode brush';
'brushtran ON';
'move 0 0';
'draw 320 400';
'stroke';
'finish';
\endnode
\node "buffer"
\title "Buffer"
\next "buffers"
\prev "brushtran"
\{ \tc 15 Buffer \} - Returns information about a specific buffer.
\nw
Usage - '\{ \tc 15 buffer <buffer_number>\} '
\{ \ts bu Sample Script\} :
options results;
'\{ \tc 15 buffer 3\} ';
info = result;
options;
parse var info bname','bnumber','xdim','ydim','xdimydim','memused','
parentname','parentnumber;
'newbuff' xdim ydim;
\endnode
\node "buffers"
\title "Buffers"
\next "cancel"
\prev "buffer"
\{ \tc 15 Buffers \} - Returns information about all buffers.
\nw
Usage - '\{ \tc 15 buffers\} '
\{ \ts bu Sample Script\} :
options results;
'\{ \tc 15 buffers\} ';
buffs = result;
options;
parse var buffs buffname','buffnumber;
\endnode
\node "cancel"
\title "Cancel"
\next "caric"
\prev "buffers"
\{ \tc 15 Cancel \} - Equivalent to hitting the cancel gadget.
\nw
Usage - '\{ \tc 15 cancel\} '
\{ \ts bu Sample Script\} :
if(flag = 0) then;
do
'\{ \tc 15 cancel\} ';
end;
\endnode
\node "caric"
\title "Caricature"
\next "cdef"
\prev "cancel"
\{ \tc 15 Caric \} - Creates an optical distortion similar to a concave lens.
Edges of a selected region are pulled toward the center creating a
caricature.
\nw
Usage - '\{ \tc 15 caric <distortion>\} '
\{ \ts bu Sample Script\} :
'area';
options results;
'askprop Distortion%: 50 0 100';
dist = result;
options;
'\{ \tc 15 caric\} ' dist;
* User Interface: \{ \tc 15 Process Panel
Geometric Transformations
Caricature\}
\endnode
\node "cdef"
\title "Color Definition"
\next "cellular"
\prev "caric"
\{ \tc 15 Cdef \} - Returns the average RGB, luma and variance of an area.
Examines a selected region and returns red, green, blue, average, luma, and
variance in a text string.
\nw
Usage - '\{ \tc 15 cdef\} '
\{ \ts bu Sample Script\} :
options results;
'\{ \tc 15 cdef\} ';
parse var result red','green','blue','average','variance;
options;
* User Interface:\tc 15 Process Panel
Define Color
\endnode
\node "cellular"
\title "Cellular / Cell"
\next "channel"
\prev "cdef"
\{ \tc 15 Cellular / Cell \} - Creates a \{ \ts i glass block effect\} .
Pixels are manipulated as points inside a cell, the resulting effect is
similar to looking through a wall of thick glass bricks.
\nw
Usage - '\{ \tc 15 cellular <red> <green> <blue> <cellsize> <borderflag>\} '
'\{ \tc 15 cell <red> <green> <blue> <cellsize> <borderflag>\} '
Red: 0 - 255
Green: 0 - 255
Blue: 0 - 255
Cellsize: (In Pixels)
Borderflag: 0 = No, 1 = Yes
\{ \ts bu Sample Script\} :
'area';
options results;
'askrgb';
colors = result;
parse var colors red','grn','blu;
'askprop Cell_Size: 50 0 100';
cell = result;
'askyn "No Border Flag" "Border Flag"';
flag = result;
options;
'\{ \tc 15 cellular\} ' red grn blu cell flag;
* User Interface: \{ \tc 15 Process Panel
Special Effects
Point Cellular\}
\endnode
\node "channel"
\title "Channel"
\next "clip"
\prev "cellular"
\{ \tc 15 Channel \} - Specifies colors to be affected by a blend.
\nw
Usage - '\{ \tc 15 channel <red> <green> <blue>\} '
Red: 0 = not affected, 1 = affected
Green: 0 = not affected, 1 = affected
Blue: 0 = not affected, 1 = affected
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 channel\} ' 0 1 0; /* green gun only */
'merge';
\endnode
\node "clip"
\title "Clip"
\next "cliphalf"
\prev "channel"
\{ \tc 15 Clip \} - Clips selected region to a new buffer
A selected region is clipped to a new buffer. If a buffer name is not
specified the program will automatically generate one.
\nw
Usage - '\{ \tc 15 clip [newname]\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 clip testbuff\} ';
See Also: \{ \ts b \link "cliphalf" "imdoc:hlp_arexx5/cliphalf"\}
* User Interface: \{ \tc 15 Process Panel
Re-Sizing and Clipping
Clip Region\}
\endnode
\node "cliphalf"
\title "Clip_Half"
\next "Clip2"
\prev "clip"
\{ \tc 15 Cliphalf \} - Clips selected region to a buffer half it's size.
\nw
Usage - '\{ \tc 15 cliphalf [newname]\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 cliphalf testbuff\} ';
See Also: \{ \ts b \link "clip" "imdoc:hlp_arexx5/clip"\}
* User Interface: \{ \tc 15 Process Panel
Re-Sizing and Clipping
Clip .5 X\}
\endnode
\node "Clip2"
\title "Clip 2X"
\next "close"
\prev "cliphalf"
\{ \tc 15 Clip2 \} - Doubles the selected region and clips it to a new
buffer.
\nw
Usage - '\{ tc 15 clip [newname]\} ';
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 clip2 testbuff\} ';
See Also: \{ \ts b \link "clip " "imdoc:hlp_arexx5/clip"
\link "cliphalf" "imdoc:hlp_arexx5/cliphalf"\}
* User Interface: \{ \tc 15 Process Panel
Re-Sizing and Clipping
Clip2\}
\endnode
\node "close"
\title "Close"
\next "colchange"
\prev "Clip2"
\{ \tc 15 Close \} - Immediate exit from Imagemaster.
Terminates operations immediately, unless used with the optional parameter
prompt. Adding the word 'prompt' allows the user to close or continue.
\nw
Usage - '\{ \tc 15 close [prompt]\} '
\{ \ts bu Sample Script\} :
if(flag = 0) then;
do
'\{ \tc 15 close prompt\} ';
end;
* User Interface: \{ \tc 15 Exit IM\}
\endnode
\node "colchange"
\title "Color Change"
\next ""
\prev "close"
\{ \tc 15 Colchange \} - Allows user to preset color change values.
Presets the color change values that are used for the grey balance, white
balance, geographic elevations, and shadowed geographic elevations.
\nw
Usage - '\{ \tc 15 colchange <red> <green> <blue> <average> <variance>\} '
\{ \TS BU Sample Script\} :
'area';
'\{ \TC 15 colchange 134 106 137 123 137\} ';
'balance';
* User Interface: \{ \tc 15 Process Panel
Standard Adjustments
Color Balance\}
\endnode